home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / prefix / RCS / prefix.man,v < prev   
Encoding:
Text File  |  1992-03-25  |  7.3 KB  |  261 lines
  1. head     1.4;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.4
  10. date     92.03.25.15.53.24;  author shirriff;  state Exp;
  11. branches ;
  12. next     1.3;
  13.  
  14. 1.3
  15. date     89.06.19.14.30.00;  author jhh;  state Exp;
  16. branches ;
  17. next     1.2;
  18.  
  19. 1.2
  20. date     88.12.30.10.08.40;  author ouster;  state Exp;
  21. branches ;
  22. next     1.1;
  23.  
  24. 1.1
  25. date     88.12.22.11.23.28;  author ouster;  state Exp;
  26. branches ;
  27. next     ;
  28.  
  29.  
  30. desc
  31. @@
  32.  
  33.  
  34. 1.4
  35. log
  36. @Added force mount flag
  37. @
  38. text
  39. @' $Header: /sprite/src/cmds/prefix/RCS/prefix.man,v 1.3 89/06/19 14:30:00 jhh Exp Locker: shirriff $ SPRITE (Berkeley)
  40. .so \*(]ltmac.sprite
  41. .HS PREFIX cmds
  42. .BS
  43. .SH NAME
  44. prefix \- Manipulate the file system prefix table
  45. .SH SYNOPSIS
  46. \fBprefix\fR [\fB\-p\fR [\fB\-x \fIprefix\fR]]\fR
  47. .br
  48. \fBprefix\fR \fB\-M \fIdevice\fR \fB[-rL] [-f] -l \fIprefix\fR
  49. .br
  50. \fBprefix\fR \fB\-[cdU] \fIprefix\fR
  51. .br
  52. \fBprefix\fR \fB\-a \fIprefix\fR [\fB\-s\fR \fIserver\fR]
  53. .br
  54. \fBprefix\fR \fB\-x \fIprefix\fR \fB\-[hH] \fIhost\fR
  55. .br
  56. \fBprefix\fR \fB\-x \fIprefix\fR \fB\-l \fIlocalName\fR
  57. .SH "OPTIONS"
  58. .IP "\fB\-p\fR" 14
  59. (The default.) Print out the prefix table.
  60. With \fB\-x\fR, print the export list of a prefix.
  61. .IP "\fB\-x \fIprefix\fR" 14
  62. Export a local directory given by \fB\-l\fR under the name \fIprefix\fR,
  63. or use with \fB\-h\fR (\fB\-H\fR) to export (not export) the prefix 
  64. to a particular host.
  65. .IP "\fB\-M \fIdevice\fR" 14
  66. Mount the device under the local name given by the \fB\-l\fR option.
  67. The local name is exported.
  68. .IP "\fB\-L\fR" 14
  69. Use with \fB\-M\fR to prevent exporting the prefix.
  70. .IP "\fB\-r\fR" 14
  71. Mount read-only.  Use with \fB\-M\fR.
  72. .IP "\fB\-U \fIprefix\fR" 14
  73. Unmount the file system with the given prefix.
  74. .IP "\fB\-f\fR" 14
  75. Force the installation of the prefix, i.e. don't do a stat to make sure
  76. the link exists.
  77. .IP "\fB\-l \fIdirName\fR" 14
  78. Specifies local name.  Used with \fB\-M\fR (mount) or \fB\-x\fR (export).
  79. .IP "\fB\-h \fIhost\fR" 14
  80. Add \fIhost\fR to the export list associated with the prefix given
  81. by the \fB\-x\fR option.
  82. \fIHost\fR can either be the name of the server or its Sprite ID.
  83. .IP "\fB\-H \fIhost\fR" 14
  84. Remove \fIhost\fR from the export list associated with the prefix given
  85. by the \fB\-x\fR option.
  86. \fIHost\fR can either be the name of the server or its Sprite ID.
  87. .IP "\fB\-a \fIprefix\fR" 14
  88. Add \fIprefix\fR to the prefix table. If the \fB\-s\fR option is not
  89. given a broadcast will be done to find the server.
  90. .IP "\fB\-s \fIserver\fR" 14
  91. Specify the server for the prefix given by the \fB\-a\fR option.
  92. \fIServer\fR can either be the name of the server or its Sprite ID.
  93. If \fIserver\fR is 0 a broadcast will be done to find the server.
  94. .IP "\fB\-c \fIprefix\fR" 14
  95. Clear the server binding for \fIprefix\fR, but retain the prefix in
  96. the prefix table.
  97. .IP "\fB\-d \fIprefix\fR" 14
  98. Delete \fIprefix\fR from the prefix table altogether.
  99. .BE
  100.  
  101. .SH DESCRIPTION
  102. .PP
  103. Prefix tables are cached mappings from file name prefixes to the
  104. servers that keep files under that prefix.   Under normal operation
  105. the prefix table is updated automatically as a side-effect of
  106. pathname lookup.  The \fBprefix\fP command is used to display the file system's
  107. prefix table,
  108. and to manipulate its individual entries.  If no options are given,
  109. prefix prints out the contents of the prefix table (just as if the
  110. \fB\-p\fR switch had been given).  If options are given, then they
  111. control what happens, as described above.
  112. .SH PREFIXES AND SPRITE
  113. .PP
  114. The presense of a prefix is indicated by remote links in the file system.
  115. A remote link is a circular symbolic link with a special type.   They
  116. are created via the "ln -r" command.  When a server encounters a remote
  117. link during lookup, it returns the prefix indicated by the remote link to
  118. the client that initiated the lookup.  The client loads the prefix (if it
  119. isn't already loaded), broadcasts for the server of the prefix (if it doesn't
  120. already know who that is), and then sends the lookup operation to the
  121. new server.  Thus the root server is bypassed after prefixes are loaded.
  122. Prefixes can be nested arbitrarily; remote links can occur in any directory.
  123. .PP
  124. Servers mount local disks under a prefix that
  125. gets exported to other Sprite hosts using the -M option.  Servers
  126. can control what hosts have access to a prefix by adding entries
  127. to an export list using the -h option.  If the export list is
  128. empty the prefix is exported to all hosts, so adding one exportee
  129. effectivly prevents access to all other hosts.  
  130. .SH KEYWORDS
  131. prefix table, mount
  132. @
  133.  
  134.  
  135. 1.3
  136. log
  137. @added -s option, also changed -[hH] to use names as well as ids.
  138. @
  139. text
  140. @d1 1
  141. a1 1
  142. ' $Header: /a/newcmds/prefix/RCS/prefix.man,v 1.2 88/12/30 10:08:40 ouster Exp Locker: jhh $ SPRITE (Berkeley)
  143. d10 1
  144. a10 1
  145. \fBprefix\fR \fB\-M \fIdevice\fR \fB[-rL] -l \fIprefix\fR
  146. d36 3
  147. @
  148.  
  149.  
  150. 1.2
  151. log
  152. @More format upgrades.
  153. @
  154. text
  155. @d1 1
  156. a1 1
  157. ' $Header: /a/newcmds/prefix/RCS/prefix.man,v 1.1 88/12/22 11:23:28 ouster Exp Locker: ouster $ SPRITE (Berkeley)
  158. d12 1
  159. a12 1
  160. \fBprefix\fR \fB\-[acdU] \fIprefix\fR
  161. d14 1
  162. a14 1
  163. \fBprefix\fR \fB\-x \fIprefix\fR \fB\-[hH] \fIhostName\fR
  164. d16 2
  165. d38 2
  166. a39 2
  167. .IP "\fB\-h \fIhostName\fR" 14
  168. Add \fIhostName\fR to the export list associated with the prefix given
  169. d41 3
  170. a43 2
  171. .IP "\fB\-H \fIhostName\fR" 14
  172. Remove \fIhostName\fR from the export list associated with the prefix given
  173. d45 1
  174. d47 6
  175. a52 1
  176. Add \fIprefix\fR to the prefix table.
  177. a88 14
  178. .PP
  179. During bootstrap a single local disk partition is mounted by the
  180. operating system under the name ``/local''.  This file system contains
  181. binaries and scripts needed during bootstrap.  In the event that
  182. a root is not found when a server broadcasts for it, it will
  183. export its own ``/local'' as ``/'' and attempt to continue booting.
  184. This simple system can lead to the wrong server exporting root,
  185. unless the root is carefully replicated (by hand).
  186. .SH FILES
  187. .DS
  188. \fB/local\fR            - Prefix for local storage found during bootstrap
  189. \fB/local/diskcmds\fR        - Boot script containing calls to the prefix command
  190. \fB/local/bootBin/prefix\fR    - Binary needed during bootstrap
  191. .DE
  192. @
  193.  
  194.  
  195. 1.1
  196. log
  197. @Initial revision
  198. @
  199. text
  200. @d1 1
  201. a1 1
  202. ' $Header: /sprite/doc/ref/cmds/RCS/prefix,v 1.3 88/10/31 11:11:44 brent Exp $ SPRITE (Berkeley)
  203. d8 1
  204. a8 1
  205. \fBprefix\fR [\fB-p\fR [\fB-x \fIprefix\fR]]\fR
  206. d10 1
  207. a10 1
  208. \fBprefix\fR \fB-M \fIdevice\fR \fB[-rL] -l \fIprefix\fR
  209. d12 1
  210. a12 1
  211. \fBprefix\fR \fB-[acdU] \fIprefix\fR
  212. d14 1
  213. a14 1
  214. \fBprefix\fR \fB-x \fIprefix\fR \fB-[hH] \fIhostName\fR
  215. d16 1
  216. a16 1
  217. \fBprefix\fR \fB-x \fIprefix\fR \fB-l \fIlocalName\fR
  218. d18 1
  219. a18 1
  220. .IP "\fB-p\fR" 14
  221. d20 4
  222. a23 4
  223. With \fB-x\fR, print the export list of a prefix.
  224. .IP "\fB-x \fIprefix\fR" 14
  225. Export a local directory given by \fB-l\fR under the name \fIprefix\fR,
  226. or use with \fB-h\fR (\fB-H\fR) to export (not export) the prefix 
  227. d25 2
  228. a26 2
  229. .IP "\fB-M \fIdevice\fR" 14
  230. Mount the device under the local name given by the \fB-l\fR option.
  231. d28 5
  232. a32 5
  233. .IP "\fB-L\fR" 14
  234. Use with \fB-M\fR to prevent exporting the prefix.
  235. .IP "\fB-r\fR" 14
  236. Mount read-only.  Use with \fB-M\fR.
  237. .IP "\fB-U \fIprefix\fR" 14
  238. d34 3
  239. a36 3
  240. .IP "\fB-l \fIdirName\fR" 14
  241. Specifies local name.  Used with \fB-M\fR (mount) or \fB-x\fR (export).
  242. .IP "\fB-h \fIhostName\fR" 14
  243. d38 2
  244. a39 2
  245. by the \fB-x\fR option.
  246. .IP "\fB-H \fIhostName\fR" 14
  247. d41 2
  248. a42 2
  249. by the \fB-x\fR option.
  250. .IP "\fB-a \fIprefix\fR" 14
  251. d44 1
  252. a44 1
  253. .IP "\fB-c \fIprefix\fR" 14
  254. d47 1
  255. a47 1
  256. .IP "\fB-d \fIprefix\fR" 14
  257. d60 1
  258. a60 1
  259. \fB-p\fR switch had been given).  If options are given, then they
  260. @
  261.